home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / biblio / bibtex / utils / bibextract / bibextract.txt < prev    next >
Text File  |  1992-11-01  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. BIBEXTRACT(1)            USER COMMANDS              BIBEXTRACT(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      bibextract - extract BibTeX entries  from  a  list  of  .bib
  10.      files
  11.  
  12. SYNOPSIS
  13.      bibextract keyword-regexp value-regexp bibfile(s)
  14.  
  15. DESCRIPTION
  16.      bibextract extracts from a list of BibTeX .bib  files  those
  17.      bibliography  entries that match a pair of specified regular
  18.      expressions, sending them to stdout, together with all  Bib-
  19.      TeX ``@Preamble{...}'' and ``@String{...}'' commands.
  20.  
  21.      The first  regular-expression  pattern,  keyword-regexp,  is
  22.      used to select which  ``keyword = "value"'' pairs to examine
  23.      further; it matches against the keyword part only.  If it is
  24.      an empty string, then all such pairs are examined.
  25.  
  26.      The second regular-expression pattern, value-regexp, is used
  27.      to  further  select  from  the  value strings of ``keyword =
  28.      "value"'' pairs the bibliography entries to be output.   The
  29.      selection algorithm therefore consists of the logical AND of
  30.      match successes against the keyword and value strings.
  31.  
  32.      bibextract can be  used  to  extract  from  a  large  BibTeX
  33.      bibliography  data base just those bibliography entries that
  34.      match a particular pair of regular expressions.
  35.  
  36. EXAMPLES
  37.      Here are some examples:
  38.  
  39.      Extract all entries mentioning chaos in any field:
  40.  
  41.           bibextract "" "chaos" bibfile(s) >new-bibtex-file"
  42.  
  43.      Extract entries with  names  Brown  or  Smith  occurring  in
  44.      either of the author or editor fields:
  45.  
  46.           bibextract  "author|editor"  "brown|smith"   bibfile(s)
  47.           >new-bibtex-file
  48.  
  49.      Extract entries for titles containing the  letter  `z'  any-
  50.      where  after  a vowel; note that single quotes are necessary
  51.      to provide the necessary protection from shell expansion:
  52.  
  53.           bibextract  "title"   '[aeiou].*z'   bibfile(s)   >new-
  54.           bibtex-file
  55.  
  56. BUGS
  57.      bibextract is not smart enough to incorporate  BibTeX  cross
  58.      references  unless they are themselves matched by the speci-
  59.      fied regular expression.
  60.  
  61.  
  62.  
  63. Version 1.02      Last change: 30 October 1992                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BIBEXTRACT(1)            USER COMMANDS              BIBEXTRACT(1)
  71.  
  72.  
  73.  
  74.      That feature should be added.
  75.  
  76. SEE ALSO
  77.      bibclean(1), bibindex(1), biblook(1), bibsort(1), bibtex(1),
  78.      citefind(1), citetags(1), latex(1), nawk(1).
  79.  
  80. FILES
  81.      /usr/local/lib/bibextract/bibextract.awk  nawk(1)    program
  82.                                                for   tag  extrac-
  83.                                                tion.
  84.  
  85.      /usr/local/bin/bibextract                 user-callable
  86.                                                shell   script  to
  87.                                                invoke nawk(1).
  88.  
  89. AUTHOR
  90.      Nelson H. F. Beebe, Ph.D.
  91.      Center for Scientific Computing
  92.      Department of Mathematics
  93.      University of Utah
  94.      Salt Lake City, UT 84112
  95.      USA
  96.      Tel: +1 801 581 5254
  97.      FAX: +1 801 581 4148
  98.      Email: <beebe@math.utah.edu>
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Version 1.02      Last change: 30 October 1992                  2
  130.  
  131.  
  132.  
  133.